home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr47 / wasm223.zip / READ.ME < prev    next >
Text File  |  1993-05-04  |  8KB  |  171 lines
  1.  
  2.                      Wolfware Assembler (WASM) Version 2.23
  3.             Copyright (c) 1985-1991 Eric Tauck. All rights reserved
  4.  
  5. Wolfware Assembler (WASM) is a free assembler for the 8086 and compatible
  6. microprocessors.  WASM is best suited for writing system utilities, TSR's, and
  7. other small programs.  The minimum system requirements are an IBM PC or
  8. compatible, 100K of free memory, and DOS 2.0 or up.  The assembler package
  9. consists of the assembler program, the user's manual, a list of version
  10. changes, and sample programs.  All of the documentation (*.DOC) files are
  11. standard text files that can be displayed on the screen or printed.
  12.  
  13. Unmodified copies of WASM may be shared and distributed.  WASM may be used
  14. without obligation to me, the author.  The most current version of WASM (2.22
  15. at the time of this writing) may be acquired on 5.25" 360K or 3.5" 720K disks
  16. by sending $10 (checks payable to Eric Tauck) to the address below.  The WASM
  17. source code (written in WASM) is available for $20.  The source code is for
  18. personal use and not for distribution.  Please add $5 for overseas shipping.
  19. Note: I expect to produce only trivial (if any) upgrades to WASM in the
  20. foreseeable future.
  21.  
  22.   Eric Tauck
  23.   1304 Deerpass Road
  24.   Marengo, IL  60152
  25.   U.S.A.
  26.  
  27.   Compuserve: 72457,1557
  28.   Internet: 72457.1557@compuserve.com
  29.  
  30.                                SUMMARY OF FILES
  31.                                ----------------
  32.  
  33. Several of the files are self-extracting archive files.  The archive files
  34. will expand when executed.  The approximate size of the expanded files (in
  35. thousands of bytes) is listed for each archive.
  36.  
  37.   HISTORY.DOC   summary of WASM version changes
  38.   WASM.DOC      WASM User's Manual
  39.   WASM.REF      WASM Instruction set reference
  40.   WASM.COM      assembler program
  41.   EDITOR.EXE    ASMED editor (archive, 184K)
  42.   LIBRARY.EXE   library files (archive, 342K)
  43.   MRED.EXE      Mr Ed editor (archive, 58K)
  44.   SAMPLES.EXE   sample programs (archive, 100K)
  45.   SLEEPER.EXE   Sleeper sample program (archive, 95K)
  46.   SESSION.EXE   Session sample program (archive, 137K)
  47.   ROUTINE.EXE   Turbo C and Turbo Pascal inline subroutines (archive, 7K)
  48.   OBJECT.EXE    object (OBJ) file support (archive, 29K)
  49.   JOHNSON.EXE   debugging utilities / sample programs (archive, 23K)
  50.   UTILITY.EXE   general utilities (archive, 98K)
  51.  
  52. Some of the sample programs expect to find the library files in the LIBRARY
  53. subdirectory.  The Session program expects itself to be in a subdirectory and
  54. the library files to be found in ..\LIBRARY.  Make sure that the assembler can
  55. locate all required files when assembling these programs.
  56.  
  57.                           VERSION 2.20 to 2.23 NOTES
  58.                           --------------------------
  59.  
  60. The user's manual has not been upgraded since version 2.11.  The only
  61. significant change is the support of the 80186 and 80286 processors.  The
  62. following instructions have been added or enhanced:
  63.  
  64.   ARPL       LAR        LTR        RCR        SHR
  65.   BOUND      LEAVE      OUTSB      ROL        SIDT
  66.   CLTS       LGDT       OUTSW      ROR        SLDT
  67.   ENTER      LIDT       POPA       SAL        SMSW
  68.   IMUL       LLDT       PUSH       SAR        STR
  69.   INSB       LMSW       PUSHA      SGDT       VERR
  70.   INSW       LSL        RCL        SHL        VERW
  71.  
  72. WASM will assemble 80186 and 80286 code regardless of the microprocessor doing
  73. the assembling.  There is no way to disable these instructions, so be careful
  74. not to run 80186 or 80286 code on an 8088 or 8086 processor.
  75.  
  76. The enhanced IMUL instruction for 80186 and 80286 processors will not assemble
  77. properly in one particular instance, when the first operand of the "IMUL reg16,
  78. reg16, imed" version is AX.  If the first operand of IMUL is AX or AL, the
  79. instruction MUST be the standard 8086 32 bit multiply.  This is to maintain
  80. compalibility with WASM code prior to the introduction of 80186/80286
  81. instructions.
  82.  
  83. The 1 bit version of the shift and roll instructions must be written without
  84. a second operand to assemble correctly for an 8088/8086:
  85.  
  86.   shl al    ;one bit shift for an 8088/8086 and 80186/80286/etc
  87.   shl al, 1 ;one bit shift for an 80186/80286/etc, WON'T WORK ON 8088/8086
  88.  
  89. The documentation file WASM.REF is a reference to all of the instructions
  90. supported by WASM, including the new and enhanced instructions.  This file
  91. replaces the Instruction Set section of the user's manual.
  92.  
  93.                                  LIBRARY NOTES
  94.                                  -------------
  95.  
  96. The TSR support provided in the library files TSR1.ASM, TSR2.ASM, and TSR3.ASM
  97. are only used by the sample program BASE.ASM.  The other sample program TSR's
  98. (like SLEEPER and AUTOPARK) do not use library TSR support.
  99.  
  100. The macro language provided in the library files MACRO1.ASM and MACRO2.ASM is
  101. still a little experimental and not fully tested.  The macro language is based
  102. on Forth and may be difficult to understand if you aren't familiar with Forth.
  103. The Session communications program is the one sample program that uses the
  104. macro language.  The files without an extension included with the Session
  105. souce code are Session macro files.
  106.  
  107.                                  OBJECT FILES
  108.                                  ------------
  109.  
  110. The WASM User's manual states that WASM cannot produce object (OBJ) files.
  111. This is no longer true.  A set of macros in the OBJECT.EXE archive allow WASM
  112. to produce object files that can be linked with most commercial languages.
  113. The files in the archive ROUTINE.EXE also allow WASM code to be used with
  114. other languages, but as inline code.
  115.  
  116.                                     JOHNSON
  117.                                     -------
  118.  
  119. These files contain some debugging utilities and example programs that have 
  120. been written and made available by D. E. Johnson.  The debugging utilities 
  121. (DHEX.INC and DREGMEM.INC) provide macros that allow you to interrupt your 
  122. program and examine the contents of the registers and memory.  The other files 
  123. demonstrate some specific programming tasks. 
  124.  
  125.                                      ASMED
  126.                                      -----
  127.  
  128. ASMED is a shareware programer's editor suitable for creating WASM source
  129. files.  You don't have to use ASMED, but it can make using WASM a whole lot
  130. easier.  Not only will ASMED edit your files, but it will assemble them and
  131. trap the assembly errors.  ASMED creates an integrated environment similar to
  132. that provided by the "Turbo" and "Quick" languages.
  133.  
  134. Before using ASMED with WASM, you must make sure it's properly configured.
  135. I've set up the default configuration file (ASMED.CNF) to trap WASM error
  136. messages.  You will only have to configure ASMED's directory option so ASMED
  137. can find WASM.  See the ASMED manual (ASMED.MAN) for details.
  138.  
  139. ASMED is shareware.  You may try it for free, but if you continue to use it,
  140. you must pay the author (not me).  See the ASMED manual for details.   Note
  141. that ASMED is a separate product from WASM.  Anything you might of paid to use
  142. WASM does not give you the right to use ASMED.  All correspondence regarding
  143. ASMED should be sent to:
  144.  
  145.   Chicago Software
  146.   1805 Brunetti Way
  147.   Suite 555
  148.   Sparks, NV 89431
  149.  
  150.   Compuserve: 72207,247
  151.   GEnie: J.CHICAGO
  152.  
  153. Note: ASMED hasn't seemed to work on my system since I upgraded to DOS 5.0.
  154. If you have problems with ASMED and need an editor, I've provided another
  155. editor called Mr Ed.
  156.  
  157.                                     MR ED
  158.                                     -----
  159.  
  160. Mr Ed is another editor you can use for creating WASM source files.  Mr Ed
  161. may be best described as "unobtrusive" -- it's pretty small and fast, but it
  162. doesn't have too many features.
  163.  
  164.                                    UTILITIES
  165.                                    ---------
  166.  
  167. This archive contains several additional archive files.  The file LH213.EXE
  168. is a self-extracting archive of LHA, the free archiver used to do all this
  169. archiving.  The other files in UTILITY.EXE are .LZH files, and LHA must be
  170. used to dearchive these files.
  171.